const implementedTypes = [
  "Data", "Text", "Long Text", "Int", "Float", 
  "Currency", "Check", "Select", "Link", 
  "Date", "Datetime", "Time", "Section Break", "Button"
];

const componentName = `Field${field.fieldtype.replace(/ /g, "")}`;
const Component = window.components?.[componentName];

coworker._config.field_handlers = {
  "Data": {
    component: "FieldData",
    event: "onBlur",
    operation: "update",
    value_processor: "text"
  },
  "Link": {
    component: "FieldLink",
    event: "onChange",
    operation: "update",
    value_processor: "text",
    _optionsResolver: "fetchLinkOptions"
  },
  "Table": {
    _handler: "_handleChildTable"
  }
  // ... all types
}

const MainForm = ({ run }) => {
  // ... existing code ...
  
  const fieldHandlers = coworker._config.field_handlers || {};
  
  // Filter by what's in config
  fields
    .filter((field) => {
      // Check if handler exists
      if (!fieldHandlers[field.fieldtype]) {
        return false;
      }
      
      // Check depends_on
      return evaluateDependsOn(field.depends_on, doc);
    })
    .map((field) => {
      const handler = fieldHandlers[field.fieldtype];
      const componentName = handler.component || `Field${field.fieldtype.replace(/ /g, "")}`;
      const Component = window.components?.[componentName];
      
      // ... rest of rendering
    });
};

const schema = {
  // ============================================================
  // SUBMISSION WORKFLOW
  // ============================================================
  is_submittable: true,        // Enables Draft → Submit → Cancel workflow
  
  // ============================================================
  // DOCUMENT PERMISSIONS & BEHAVIOR
  // ============================================================
  read_only: false,            // Entire doctype is read-only
  allow_rename: true,          // Can rename after save
  allow_copy: true,            // Show "Duplicate" button
  allow_import: true,          // Enable bulk import
  
  // ============================================================
  // CHILD TABLE INDICATORS
  // ============================================================
  istable: false,              // Is this a child table doctype?
  editable_grid: true,         // Child table supports inline edit
  
  // ============================================================
  // TRACKING & AUDIT
  // ============================================================
  track_changes: true,         // Enable version history
  track_seen: true,            // Track who viewed document
  max_attachments: 10,         // Attachment limit (0 = unlimited)
  
  // ============================================================
  // UI SHORTCUTS
  // ============================================================
  quick_entry: true,           // Show quick-create dialog
  title_field: "customer_name", // Field used for document title
  
  // ============================================================
  // CUSTOM BEHAVIORS
  // ============================================================
  autoname: "CUST-.####",      // Auto-naming pattern
  naming_rule: "By fieldname"  // or "Autoincrement" or "By Script"
}

const doc = {
  // ============================================================
  // DOCUMENT STATE (Core Frappe)
  // ============================================================
  docstatus: 0,          // 0 = Draft, 1 = Submitted, 2 = Cancelled
  
  // ============================================================
  // SAVE STATE FLAGS
  // ============================================================
  __islocal: true,       // Not yet saved to DB (new document)
  __unsaved: true,       // Has unsaved changes
  __modified: false,     // Modified since last load
  
  // ============================================================
  // AUDIT FIELDS
  // ============================================================
  name: "CUST-0001",     // Unique document ID
  owner: "user@example.com",
  creation: "2025-01-08 10:30:00",
  modified: "2025-01-08 11:45:00",
  modified_by: "admin@example.com",
  
  // ============================================================
  // WORKFLOW STATE (if workflow enabled)
  // ============================================================
  workflow_state: "Pending Approval",  // Current workflow state
  
  // ============================================================
  // CHILD DOCUMENT FLAGS
  // ============================================================
  parenttype: "Sales Order",   // For child docs
  parentfield: "items",        // Field name in parent
  parent: "SO-0001",          // Parent document name
  idx: 1                      // Row index in child table
}

const field = {
  // ============================================================
  // BASIC ATTRIBUTES
  // ============================================================
  fieldname: "customer_name",
  fieldtype: "Data",
  label: "Customer Name",
  
  // ============================================================
  // VALIDATION
  // ============================================================
  reqd: true,                    // Required field
  mandatory_depends_on: "eval:doc.status=='Active'",
  
  // ============================================================
  // EDIT BEHAVIOR
  // ============================================================
  read_only: false,
  read_only_depends_on: "eval:doc.docstatus==1",
  allow_on_submit: false,        // Can edit after submission
  
  // ============================================================
  // VISIBILITY
  // ============================================================
  hidden: false,
  depends_on: "eval:doc.customer_type=='Company'",
  
  // ============================================================
  // GRID/LIST BEHAVIOR
  // ============================================================
  in_list_view: true,            // Show in child table grid
  in_standard_filter: true,      // Show in list filters
  in_global_search: true,        // Include in global search
  
  // ============================================================
  // LINK BEHAVIOR
  // ============================================================
  options: "Customer",           // For Link fields
  ignore_user_permissions: false,
  
  // ============================================================
  // DEFAULTS
  // ============================================================
  default: "Draft",
  fetch_from: "customer.customer_name"  // Fetch value from linked doc
}

// ============================================================
// SAVE BUTTON BEHAVIOR
// ============================================================
const canSave = {
  condition: "!doc.__islocal && doc.__unsaved && docstatus === 0",
  label: "Save",
  operation: "update"
}

const canSaveNew = {
  condition: "doc.__islocal",
  label: "Save",
  operation: "create"
}

// ============================================================
// SUBMIT BUTTON BEHAVIOR
// ============================================================
const canSubmit = {
  condition: "schema.is_submittable && doc.docstatus === 0 && !doc.__unsaved",
  label: "Submit",
  operation: "submit",
  nextDocstatus: 1
}

// ============================================================
// CANCEL BUTTON BEHAVIOR
// ============================================================
const canCancel = {
  condition: "schema.is_submittable && doc.docstatus === 1",
  label: "Cancel",
  operation: "cancel",
  nextDocstatus: 2
}

// ============================================================
// AMEND BUTTON BEHAVIOR
//

schema.title_field       // Field to use for document title (e.g., "customer_name")
schema.fields           // Array of field definitions
schema.is_submittable   // Boolean - enables docstatus workflow (Draft/Submitted/Cancelled)

doc.docstatus           // 0 = Draft, 1 = Submitted, 2 = Cancelled
doc.doctype             // Document type name
doc.name                // Document ID/name
doc[titleField]         // Dynamic - value of the title field
doc[field.fieldname]    // Dynamic - field values

field.fieldtype         // Type like "Data", "Link", "Check", etc.
field.fieldname         // Field identifier (e.g., "customer_name")
field.depends_on        // Conditional visibility expression

run.output.schema       // Schema loaded from operation
run.doc                 // Current document data
run.source_doctype      // Fallback for doctype
run.target_doctype      // Fallback for doctype
run._validationErrors   // Array of validation errors
  └─ .field            // Field name with error
  └─ .message          // Error message to display

// Title display logic
const title = doc[schema.title_field] || doc.name || 'New';

// Badge display logic
if (schema.is_submittable && doc.docstatus !== undefined) {
  // Show: Draft (0), Submitted (1), or Cancelled (2)
}

// Field filtering logic
fields.filter(field => {
  // 1. Check if fieldtype is implemented
  // 2. Check if depends_on evaluates to true
})

// Error display logic
const fieldError = run._validationErrors?.find(
  err => err.field === field.fieldname
)?.message;

schema.fields              // Array of field definitions
schema.is_submittable      // 1 = enables Draft/Submit/Cancel workflow
schema._autosave           // 0 = disabled, 1 = enabled (default 1 if undefined)
schema._schema_doctype     // Doctype name (used in logging)

doc[field.fieldname]       // Dynamic field values
doc.name                   // Document ID (used to detect "new-" prefix)
doc.docstatus              // 0 = Draft, 1 = Submitted, 2 = Cancelled

// Core
run.operation              // Operation name (create/update/select/etc)
run.source_doctype         // For reads/updates (FROM existing)
run.target_doctype         // For creates (TO new)
run.input                  // Delta changes (unwrapped)
run.input.data             // Delta changes (wrapped format)
run.query                  // Query object
run.query.where            // Filter conditions

// Output
run.output                 // Output object
run.output.schema          // Loaded schema
run.output.data            // Array of result documents
run.output.data[0]         // First document (used as "original")
run.output.meta            // Metadata

// Options
run.options                // Options object
run.options.draft          // Boolean - enables draft mode (set by execute())
run.options.skipController // Boolean - bypass controller entirely
run.options.skipSchema     // Boolean - skip schema loading
run.options.skipValidation // Boolean - skip validation
run.options.includeSchema  // Boolean - include schema in output

// Internal State Flags (prefixed with _)
run._items                 // Fetched original items (passed to handler)
run._saving                // Boolean - save in progress
run._validationErrors      // Array of validation error messages
run._saveError             // String - save error message

// Response
run.success                // Boolean - operation succeeded
run.error                  // Error object
run.error.message          // Error message string

opConfig.type              // "read" | "write" | "custom"
opConfig.requiresSchema    // Boolean - load schema before execution
opConfig.validate          // Boolean - validate before write
opConfig.fetchOriginals    // Boolean - fetch existing docs before update
opConfig.draft             // Boolean - default draft mode for this operation

field.fieldname            // Field identifier
field.label                // Field label (for error messages)
field.fieldtype            // "Int" | "Float" | "Email" | "Date" | etc
field.reqd                 // Boolean - required field
field.length               // Number - max length
field.min_value            // Number - minimum value
field.max_value            // Number - maximum value

// Draft mode detection
if (run.options?.draft) { /* UI form mode with save() */ }

// Autosave control
if (schema.is_submittable === 1) {
  if (schema._autosave === 0) { /* blocked */ }
  if (doc.docstatus !== 0) { /* blocked */ }
}

// New vs Update detection
const isNew = !merged.name || merged.name.startsWith("new-");

// Save state
if (run._saving) { /* show spinner */ }
if (run._validationErrors) { /* show errors */ }
if (run._saveError) { /* show error banner */ }

async execute(run_doc) {
  const { operation, options = {} } = run_doc;

  // ✅ SINGLE SOURCE OF TRUTH: Set draft from operation config
  if (options.draft === undefined) {
    const opConfig = coworker._config.operations[operation];
    run_doc.options = run_doc.options || {};
    run_doc.options.draft = opConfig?.draft ?? false;  // ← Assignment here
  }
  // ...
}

// User opens form to edit existing doc
await coworker.run({
  operation: 'select',
  source_doctype: 'Customer',
  query: { where: { name: 'CUST-001' } },
  options: { 
    draft: true  // ← Explicitly set by UI
  }
});

// Config defines operation behavior
coworker._config.operations = {
  select: {
    type: "read",
    requiresSchema: true,
    draft: true  // ← Default for ALL select operations
  },
  update: {
    type: "write",
    requiresSchema: true,
    validate: true,
    fetchOriginals: true,
    draft: false  // ← Updates are immediate, not draft
  }
}

// UI calls without explicit draft flag
await coworker.run({
  operation: 'select',  // ← Will get draft: true from config
  source_doctype: 'Customer',
  query: { where: { name: 'CUST-001' } }
});

// No draft flag anywhere
await coworker.run({
  operation: 'custom_operation',  // ← Not in config
  doctype: 'Task'
  // draft will be: false (default)
});

// ✅ ENABLED in Draft Mode:
run.input = {}           // Delta accumulator (changes only)
run.doc = { ...original, ...run.input }  // Live merged state

// User can:
await run.save()         // Persist to DB
await run.autoSave()     // Auto-persist if valid

// Validation errors stored but don't block:
run._validationErrors = [...]  // Shown in UI
run._saving = true            // Show spinner
run._saveError = "..."        // Show error banner

async save(run) {
  // ✅ Check draft flag (set by execute())
  if (!run.options?.draft) {
    console.warn("save() called on non-draft run");
    return {
      success: false,
      error: { message: "Document not in draft mode" }
    };
  }
  // ... validation and DB save
}

async autoSave(run) {
  // ✅ Check draft flag (set by execute())
  if (!run.options?.draft) return;  // Silent exit
  
  // Additional checks:
  if (schema?.is_submittable === 1) {
    if (schema._autosave === 0) return;  // Disabled
    if (run.doc?.docstatus !== 0) return;  // Not draft status
  }
  
  if (!this.isComplete(run)) return;  // Invalid
  
  return await this.save(run);
}

// 1. User opens form
const run = await coworker.run({
  operation: 'select',
  source_doctype: 'Customer',
  query: { where: { name: 'CUST-001' } },
  options: { draft: true }  // ← Enable draft mode
});
// → execute() keeps draft: true
// → run.options.draft === true

// 2. User types in field
run.input.customer_name = 'New Name';
// → Changes accumulate in run.input
// → UI shows merged: { ...original, ...input }

// 3. AutoSave triggers (debounced)
await coworker.controller.autoSave(run);
// → Checks: draft? valid? submittable rules?
// → Calls save() if all pass

// 4. Save creates child run
await run.child({
  operation: 'update',
  source_doctype: 'Customer',
  input: { ...original, ...run.input },
  query: { where: { name: 'CUST-001' } },
  options: { includeSchema: false }  // ← No draft flag (immediate save)
});
// → Child run has draft: false (from update operation config)
// → Executes immediately without draft accumulation

coworker._config.operations = {
  select: {
    draft: true   // ← Forms need draft mode
  },
  create: {
    draft: false  // ← API creates are immediate
  },
  update: {
    draft: false  // ← API updates are immediate
  },
  delete: {
    draft: false  // ← Deletes are always immediate
  }
}

// In save() method - creates a CHILD run
const saveRun = await run.child({
  operation: isNew ? "create" : "update",  // ← Uses config default
  input: merged,
  options: {
    includeSchema: false  // ← No draft: false override!
  }
});

operations: {
  // ============================================================
  // READ OPERATIONS
  // ============================================================
  select: {
    type: "read",
    draft: true,  // ✅ CHANGED - UI opens form for editing
    requiresSchema: true,  // ✅ CHANGED - Forms need schema
    validate: false,
    fetchOriginals: false,
  },
  takeone: {
    type: "read", 
    draft: true,  // ✅ CHANGED - Single doc form editing
    requiresSchema: true,  // ✅ CHANGED - Forms need schema
    validate: false,
    fetchOriginals: false,
  },
  
  // ============================================================
  // WRITE OPERATIONS (System-initiated - immediate execution)
  // ============================================================
  create: {
    type: "write",
    draft: false,  // ✅ CHANGED - Direct DB write (called by save())
    requiresSchema: true,
    validate: true,
    fetchOriginals: false,
  },
  update: {
    type: "write",
    draft: false,  // ✅ CHANGED - Direct DB write (called by save())
    requiresSchema: true,
    validate: true,
    fetchOriginals: true,
  },
  delete: {
    type: "write",
    draft: false,  // ✅ Correct - Always immediate
    requiresSchema: false,
    validate: false,
    fetchOriginals: true,
  },
  upsert: {
    type: "write",
    draft: false,  // ✅ CHANGED - Direct DB write
    requiresSchema: true,
    validate: true,
    fetchOriginals: true,
  },
  bulk_update: {
    type: "write",
    draft: false,  // ✅ Correct - Bulk ops immediate
    requiresSchema: false,
    validate: false,
    fetchOriginals: false,
  },
}

// 1. UI opens form (USER action)
const run = await coworker.run({
  operation: 'select',  // draft: true from config ✅
  source_doctype: 'Customer',
  query: { where: { name: 'CUST-001' } }
});
// → run.options.draft = true
// → User can edit, validation accumulates

// 2. User clicks Save (or autoSave triggers)
await run.save();
// → Validates
// → Creates child run:

const saveRun = await run.child({
  operation: 'update',  // draft: false from config ✅
  source_doctype: 'Customer',
  input: merged,
  query: { where: { name: 'CUST-001' } }
});
// → saveRun.options.draft = false
// → Executes immediately to DB ✅

const saveRun = await run.child({
  operation: isNew ? "create" : "update",
  input: merged,
  query: isNew ? undefined : { where: { name: merged.name } },
  options: {
    includeSchema: false,
    draft: false  // ✅ ADD THIS - Force immediate execution
  }
});

async save(run) {
  // ... validation ...
  
  const saveRun = await run.child({
    operation: isNew ? "create" : "update",
    input: merged,
    query: isNew ? undefined : { where: { name: merged.name } },
    options: {
      includeSchema: false,  // ← Only this is set
    },
  });
  
  // Child run EXECUTES and returns result ✅
  if (saveRun.success) {
    // Update local state with result
  }
}

select: {
  draft: false,  // ✅ Read-only viewing, no save() needed
}
create: {
  draft: true,   // ✅ Can be called directly from UI for new forms
}
update: {
  draft: true,   // ✅ Can be called directly from UI for edit forms
}

// Creating new document
const run = await coworker.run({
  operation: 'create',  // draft: true ✅
  target_doctype: 'Customer',
  input: { name: 'new-customer-1' }
});
// User edits in form
await run.save();  // Creates child 'create' → executes ✅

// Editing existing document  
const run = await coworker.run({
  operation: 'update',  // draft: true ✅
  source_doctype: 'Customer',
  query: { where: { name: 'CUST-001' }}
});
// User edits in form
await run.save();  // Creates child 'update' → executes ✅